Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / gtmisc.arc / DSZ.DOC next >

Wrap

Text File | 1987-04-24 | 28KB | 705 lines

_______________________________________________________________________________ PROGRAM: DSZ.EXE Version 04/06/87 PURPOSE: Utility to Transfer Files to/from Remote USAGE: Ctrl-Break to Abort DSZ [port n] [speed s] [d] [p_#] command [-options] [filename(s)] _______________________________________________________________________________ note: Use MODE COM1:1200,N,8,1,- in AUTOEXEC.BAT to initialize. _______________________________________________________________________________ Receive File(s) from Remote Protocol: DSZ rx -y Filename.ext Xmodem/Sum Ymodem/Sum DSZ rc -y Filename.ext Xmodem/CRC Ymodem/CRC DSZ rc -gy Filename.ext Ymodem-G DSZ rb -y Ymodem-Batch DSZ rb -gy Ymodem-G Batch DSZ rz -y Zmodem-Batch _______________________________________________________________________________ Transmit File(s) to Remote Protocol: DSZ sx Filename.ext Xmodem/CRC Xmodem/Sum DSZ sx -k Filename.ext Ymodem/CRC Ymodem/Sum DSZ sx -k Filename.ext Ymodem-G DSZ sb -k Filename(s) Ymodem-Batch DSZ sb -k Filename(s) Ymodem-G Batch DSZ sz Filename(s) Zmodem-Batch _______________________________________________________________________________ note: Xmodem uses 128-Byte Packets and CRC-16 error checking. Ymodem uses 1024-Byte Packets and CRC-16 error checking. Use SET 1:0,4:2,5:0,7:8,12:0 to configure TeleNet for Ymodem. note: Zmodem uses free-flowing Packets and CRC-32 error checking. XON/XOFF - Handshaking required for Zmodem-Batch Transfers. Use SET 1:0,4:2,5:1,7:8,12:1 to configure TeleNet for Zmodem. note: Ymodem-G uses free-flowing Packets and no error checking. RTS/CTS - Handshaking required for Ymodem-G Transfers. Use Microcom Network Protocol "MNP" Modems for Ymodem-G. Use a RamDisk to Receive Files during "free flow" Transfers. _______________________________________________________________________________ Command Line Switches Defaults: port n Open DOS COMn: for data inp/out. Port "COM1:" speed s Set Baud 300 1200 2400 4800 9600 Current Baud restrict (Receiver) to current Directory Unrestricted con Redirect Display Output to CON: Standard Out d Direct Connect No Carrier Detect DCD Checking _______________________________________________________________________________ Command Line Parameters Usage: pp50 Receiver Timeout - Gaps in Packets rc rb rz pt100 Receiver Timeout - Wait for Sender rc rb rz pT600 Sender Timeout - Wait for Receiver sx sb sz pL1024 Force Zmodem Packet Length to 1-Kb sz _______________________________________________________________________________ note: p_# parameters unavailable after DSZ.EXE version 04/06/87. _______________________________________________________________________________ Command Line Options Usage: -y Overwrite Existing File rx rc rb rz -k Transmit 1-Kb Packets sx sb -g Ignore ACK/NAK Checking rc rb .... see File: ZCOMMDOC.ARC ..... _______________________________________________________________________________ File Transfer Performance XMODEM YMODEM ZMODEM YMODEM-G Protocol Overhead Characters 4803 603 3600 503 Transfer Protocol Round Trips 803 103 5 5 (direct) Trip Time ... at 40ms 32.12s 4.12s 0.2s 0.2s (direct) Transfer Time at 40ms 925s 862s 883s 857s (netwrk) Trip Time ... at 5s 4015s 515s 25s 25s (netwrk) Transfer Time at 5s 5761s 1373s 918s 882s DSZ - PCBoard File Transfers XMODEM YMODEM ZMODEM YMODEM-G TeleNet Benchmarks: 48cps 96cps 113cps 118cps Relative Efficiency: 40% 80% 95% 98% _______________________________________________________________________________ Performance Considerations (1) The Serial Port is COM1: default. Using DOS MODE to init the Port, and using the "port 1" parameter, appears to help DSZ manage its interrupt-driven Port Buffer. (2) The Receiver should initiate Xmodem, Ymodem, and Ymodem-G. (3) The Receiver Timeouts are pp50 and pt100 default. Transfers are smoother over TeleNet when the Receiver is "Relaxed" by using pp100 and pt600. This may vary with different CPUs. (4) The Sender should initiate Zmodem-Batch. After beginning, the Receiver can select to DownLoad File(s) with Zmodem or Ymodem-G Batch protocols - the Sender will adjust. (5) During "free-flowing" Zmodem and Ymodem-G DownLoads, DSZ writes data to the Disk in 1024-Byte Blocks. Performance improves using a RamDisk; above 2400 Baud it is essential. (6) The TeleNet TERMINAL=D1 at LogOn increases transfer speed by suppressing NUL characters in the data stream. (7) The TeleNet SET 1:0,4:2,7:8 command configures PCPursuit for High-Speed, Binary File Transfers: 1:0 - Disables <cr>@<cr> escape to '@' Prompt 4:2 - Minimizes Network Transmission Delays 7:8 - Configures [Break] escape to '@' Prompt (8) The TeleNet SET 5:1,12:1 command establishes Handshaking between DSZ and the TeleNet PAD. It should only be used for Zmodem Transfers. Xmodem & Ymodem are not "free-flowing" Protocols, and so require no Flow Control: 5:1 - Enables XON/XOFF Flow Control from DSZ to PAD 12:1 - Enables XON/XOFF Flow Control from PAD to Host _______________________________________________________________________________ note: Connect to PCPursuit Target City before using "SET" commands. _______________________________________________________________________________ ┌─────┐ ╔═══╡ SAT ╞═══╗ ║ └─────┘ ║ ║ ║ XON / XOFF ║ TELENET ║ XON / XOFF ┌─────────┴─────────┐ ║ ║ ┌─────────┴─────────┐ ┌─────┐ ┌─────┐ ┌──╨──┐ ┌──╨──┐ ┌─────┐ ┌─────┐ │ TTY ╞═══════╡ MDM ╞═══════╡ PAD │ │ PAD ╞═══════╡ MDM ╞═══════╡ BBS │ └─────┘ RS232 └─────┘ 1200B └─────┘ └─────┘ 1200B └─────┘ RS232 └─────┘ └──┬──┘ └──┬──┘ └──┬──┘ └──┬──┘ RTS/CTS MNP local RTS/CTS Optimization of TeleNet - Zmodem _______________________________________________________________________________ CED Syntax - Running DSZ from TTY Shell CED SYN TTY d:\telix.exe o q start.scr (Telix v2.12) CED SYN PRO d:\procomm (ProComm v2.42) CED SYN SST d:\qmodem (DSZ integrated) (Qmodem v3.0) CED SYN BD1 d:\boyan (DSZ integrated) (Boyan vD1) CED SYN GTO d:\gto (DSZ integrated) (PowerComm v12.10) RX d:\dsz.exe port 1 pp100 pt600 rc -y %1^EXIT Xmodem/CRC SX d:\dsz.exe port 1 pT600 sx %1^EXIT RY d:\dsz.exe port 1 pp100 pt600 rc -y %1^EXIT Ymodem/CRC SY d:\dsz.exe port 1 pT600 sx -k %1^EXIT RG d:\dsz.exe port 1 pp100 pt600 rc -gy %1^EXIT Ymodem-G SG d:\dsz.exe port 1 pT600 sx -k %1^EXIT RB d:\dsz.exe port 1 pp100 pt600 rb -y^EXIT Ymodem-Batch SB d:\dsz.exe port 1 pT600 sb -k %1 %2^EXIT RGB d:\dsz.exe port 1 pp100 pt600 rb -gy^EXIT Ymodem-G Batch SGB d:\dsz.exe port 1 pT600 sb -k %1 %2^EXIT RZ d:\dsz.exe port 1 pp100 pt600 rz -y^EXIT Zmodem-Batch SZ d:\dsz.exe port 1 pT600 pL1024 sz %1 %2^EXIT _______________________________________________________________________________ File Transfer Commands at DOS Prompt Xmodem/CRC RX d:\filename.ext SX d:\filename.ext Ymodem/CRC RY d:\filename.ext SY d:\filename.ext Ymodem-G RG d:\filename.ext SG d:\filename.ext Ymodem-Batch RB SB d:\filename(s) Ymodem-G Batch RGB SGB d:\filename(s) Zmodem-Batch RZ SZ d:\filename(s) _______________________________________________________________________________ File Transfer Protocols ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ XMODEM/SUM File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ NAK ║ ║ NAK ║ ║ NAK ║ ║ STX 01 FE Data[128] SUM SUM ║ ║ ACK ║ ║ STX 02 FD Data[128] SUM SUM ║ ║ NAK ║ ║ STX 02 FD Data[128] SUM SUM ║ ║ ACK ║ ║ STX 03 FC Data[128] SUM SUM ║ ║ ACK ║ ║ STX 04 FB Data[100] CPMEOF[28] SUM SUM ║ ║ ACK ║ ║ EOT ║ ║ ACK ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ XMODEM/CRC File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ C ║ ║ C ║ ║ C ║ ║ STX 01 FE Data[128] CRC CRC ║ ║ ACK ║ ║ STX 02 FD Data[128] CRC CRC ║ ║ NAK ║ ║ STX 02 FD Data[128] CRC CRC ║ ║ ACK ║ ║ STX 03 FC Data[128] CRC CRC ║ ║ ACK ║ ║ STX 04 FB Data[100] CPMEOF[28] CRC CRC ║ ║ ACK ║ ║ EOT ║ ║ ACK ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ YMODEM/CRC File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ C ║ ║ C ║ ║ C ║ ║ SOH 01 FE Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ NAK ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 03 FC Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 04 FB Data[1000] CPMEOF[24] CRC CRC ║ ║ ACK ║ ║ EOT ║ ║ ACK ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ YMODEM-G File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ G ║ ║ G ║ ║ G ║ ║ SOH 01 FE Data[1024] CRC CRC ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ SOH 03 FC Data[1024] CRC CRC ║ ║ SOH 04 FB Data[1000] CPMEOF[24] CRC CRC ║ ║ EOT ║ ║ ACK ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ YMODEM-BATCH File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ C ║ ║ C ║ ║ SOH 00 FF FILENAME.EXT NUL[116] CRC CRC ║ ║ ACK ║ ║ C ║ ║ SOH 01 FE Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ ACK ║ ║ SOH 03 FC Data[1000] CPMEOF[24] CRC CRC ║ ║ ACK ║ ║ EOT ║ ║ ACK ║ ║ C ║ ║ SOH 00 FF NUL[128] CRC CRC ║ ║ ACK ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ YMODEM-G Batch File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ G ║ ║ G ║ ║ G ║ ║ SOH 00 FF FILENAME.EXT NUL[116] CRC CRC ║ ║ G ║ ║ SOH 01 FE Data[1024] CRC CRC ║ ║ SOH 02 FD Data[1024] CRC CRC ║ ║ SOH 03 FC Data[1024] CRC CRC ║ ║ SOH 04 FB Data[1000] CPMEOF[24] CRC CRC ║ ║ EOT ║ ║ ACK ║ ║ G ║ ║ SOH 00 FF NUL[128] CRC CRC ║ ║ ACK ║ ║ ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ ╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ ZMODEM - Batch File Transfer Protocol ║ ║ ║ ║ SENDER RECEIVER ║ ║ ║ ║ rz CR ║ ║ ZRQINIT(0) XON ║ ║ ZRINIT ║ ║ ZFILE ║ ║ ZRPOS ║ ║ ZDATA ║ ║ Data[1024] CRC-32 ║ ║ Data[1024] CRC-32 ║ ║ Data[1024] CRC-32 ║ ║ ZEOF ║ ║ ZRINIT ║ ║ ZFIN ║ ║ ZFIN ║ ║ OO ║ ║ ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ _______________________________________________________________________________ Options for File Transfers Source: File ZCOMMDOC.ARC 04/06/87 Note: options + n y p are mutually exclusive. + Append Data to Existing File rx rc rb rz + Append Data to Existing File sx sb sz EXAMPLE: rz -+ EXAMPLE: sz -+ ONAME=master.log *.log Appends Sender's *.log Files to Receiver's master.log n Transfer if File not Found rb rz n Transfer if File not Found sb sz EXAMPLE: rz -n EXAMPLE: sz -n *.log Transfers all *.log Files Receiver does not have y Overwrite Existing File rx rc rb rz y Overwrite Existing File sz EXAMPLE: rz -y EXAMPLE: sz -y *.log Transfers all *.log Files to Receiver _______________________________________________________________________________ Note: options a b r are mutually exclusive. a Convert File to ASCII Format rz rc rb rz a Convert File to ASCII Format sz EXAMPLE: rz -a EXAMPLE: sz -a MESSAGE.TXT Converts File MESSAGE.TXT to Receiver ASCII Format b Inhibit ASCII File Conversion sz EXAMPLE: sz -b PROGRAM.EXE Transfers File PROGRAM.EXE to Receiver BINARY Format r Recover Interrupted Transfer rz r Recover Interrupted Transfer sz EXAMPLE: rz -r EXAMPLE: sz -r PROGRAM.EXE Resumes an interrupted File Transfer _______________________________________________________________________________ c Use Compuserve CIS-B Protocol rx EXAMPLE: rx -c filename.ext Uses CRC-16 error checking CIS-B E Escape only Ctrl-X [CAN] sz EXAMPLE: sz -E filename.ext All other characters are sent to Receiver e Escape only Ctrl- characters sz EXAMPLE: sz -e filename.ext All other characters are sent to Receiver f Send Full PathName to Receiver sb sz EXAMPLE: sz -f d:\path\*.ARC File(s) are are sent to Receiver's d:\path g Ignore ACK/NAK Block Checking rx rc rb EXAMPLE: rb -g EXAMPLE: rc -g filename.ext Receives File Ymodem-G Protocol j Use FIDO XMODEM Protocol rx rc j Use FIDO XMODEM Protocol sx EXAMPLE: rc -j filename.ext EXAMPLE: sx -j filename.ext Transfers File FIDO XMODEM k Use 1-Kb Packets (Blocks) sx sb EXAMPLE: rx -k filename.ext Transfers File Ymodem/CRC-Sum v View data being Transferred rx rc rb rz v View data being Transferred sx sb sz EXAMPLE: rz -v EXAMPLE: sz -v MESSAGE.TXT Displays File being transferred _______________________________________________________________________________